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Simele CP/M BDOS Functional Specification 


Simple CP/M“s BDOS is basicly a CP/M 2.2 BDOS that has been 
enhanced to contain some functionality added to CP/M PLUS. The BIOS 
organization of Simple CP/M is also verv similar to CP/M 2.2. The 
target size of the Simele CP/M BDOS module is 16 Pages, 2 pases larger 
than CF/M 2.2“s BOOS. 


z The followings items describe the major BDOS additions to Simple 
CP/M. 


1. The BOOS automatically reloss in a disk when it encounters a 
directory checksum error instead of markina the disk read/only. 
If a media chanse is detected after a file is opened an a drive, 
the BOOS returns an error on subsequent read or write oreratians 
for the file. 


2. Simple CF/M does not reset drives at warm start like CP/M 2.2. 
However, in order to ensure accurate disk space computations in 
the BDOS and by transient prosrams such as STAT, the BIOS disk 
allocation vectors for Simple CP/M are twice as larse as in CF/M 
2.2. Each allocation vector consists of two CP/M 2.2 allocation 
vectors where the first vector records temporarily allocated 
blocks resultina from write operations and the second vector 
records Permanently allocated blocks resulting from close 
operations. At drive losin both vectors are initialized to the 
same value. At warm start the second vector is copied ta the 
first vector. 


Note that the BDOS maintains a flags which the CCF can access after 
receivins control fram the BIOS warm start routine to determine if 
the warm start occurred as the result of a ^C typed at the system 
Prompt. If so, the CCP makes a disk reset call to reset the disk 
system. 


3. The BOOS does not Perform record blockins/deblockins but refers 
the task ta the BIOS as in CP/M 2.2. The BIOS has three new 
functions: FLUSH, DISCARD and MOVE. 


The BDOS calls the BIOS FLUSH function ta signal the BIOS to write 
any write-pPendings bloackinas/deblockins buffers. The FLUSH function 
has no parameters but returns an error code ta the BOOS like the 
BIOS READ and WRITE functions. 


The BDOS calls the DISCARD function to sianal the BIOS to discard 
the contents of blockins/deblockins buffers. The DISCARD function 
has a parameter in resister C which specifies a drive value. If 
the drive Parameter matches the drive of an active 
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blockins/deblockins buffer, the buffer must be discarded. IF 
resister C = OFFH, all active buffers must be discarded 
unconditionally. The DISCARD function does not return an error 
code to the BDOS. 


The MOVE function is called to transfer data in memory. This 
function allows Z880 systems to use the LDIR instruction to move 
data. 

To promote compatibility with existins CP/M 2.2 implementations, 
the BDOS references these new functions as externals instead of 
assigning locations for the functions in the BIOS jump vector. 


Simple CP/M is rommable. The BOGS is linked with the BIOS with an 
absolute code origin (LINK L switch) and data orisin (LINK — 
switch). The BDOS has two PUBLIC entry Points, CSINIT and WSINIT, 
that the BIOS calls to handle BOOS initialization. CSINIT., the 
BOOS cold start initialization routine, is called from the BIOS 
cold boot routine. WSINIT. the BDOS warm start initialization 
routine, is called from the BIOS warm start routine. 


The BOOS Orpen function opens system files an user zero fram other 
user numbers. This makes the USER facility more friendly. Note 
that the BDOS does not allow write operations toa user zero files 
opened in this way. 


Simple CP/M handles submit file more efficiently than CP/M 2.2. 
When a file named #$%$.SUB is created (by the BOOS Make or Rename 
functions) on drive A. the BOOS sets a flasa called the submit 
flas. The CCF accesses this flas to determine when it should open 
the $$$.SUB file and besin a submit process. The BDOS also has a 
20 byte save area that the CCF uses to save the last 20 bytes of 
the submit FCB. This eliminates the need to open and close the 
submit FCB for every command. The XSUB utility has alsa been 
modified to be consistent with the new submit conventions. The 
BDOS also resets the submit flas if the $$4%.SUB file on drive ÀA is 
deleted or renamed, thereby terminating the submit process. Thus, 
with the exception of those prosrams that modify the $#$%.SUB file 
while a submit is in prosress, submit processing under Simple CP/M 
is functionally equivalent ta submit processins under CP/M 2.2. 


The BOOS error messages are displayed in the CP/M PLUS formats 
"CP/M Error on =", with the errors identified as "Disk I/O", 
“Invalid drive", “Read/Only File". or "Read/Only Disk". Note that 
the BDOS error message routine, CPMERR. is assembled independenti 
and linked with the BOOS and BIOS modules to build a Simple CP/M 
system. This allows for easy customization of the BIOS error 
messages to address foreign markets. 


The BDOS supports the return error mode of CP/M PLUS. Function 45 
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is supported. 


The BOOS includes same changes ta CONBDOS. “S support is nat 
disabled if the oane-character look-ahead buffer contains a 
character other than a ^S. In addition, function & does mot 


ignore the look-ahead buffer. 


The BOOS supports function 107 (Get/Set Console Mode). function 
110 (Get/Set Gutrput Delimiter), function 111 (Print Block to 
Console), and function 112 (Print Block ta List Device). 


Functions 111 and 112 allow a block of characters to be output ta 
the console or list device. A parameter control structure 
consisting of two adjacent word values specifies the characters to 
be autrput. The first word value specifies the address af the 
first character to be output. The second word value specifies the 
number of characters. 


The Console Mode (bit 4) controls whether escarpe sequence decadins 
is to be performed in the BIOS for console output. The Console 
Mode bits settinss of CP/M PLUS (0 - 3, 3, 9%) are not supported. 
Note that enabling escape sequence decodins disables tab 
expansion, printer echo, and ^S status checkina for BOOS functions 
2> 7. and 111. The Coansole Mode variable, CONMODE, is a BDOS 
Public which the BIOS CONOUT routine can interrosate directly. 


Function 110 specifies the delimiter for function 9. Print Strings. 
The default value for the delimiter is a “$”. The delimiter is 
also set to “$°% at warm start. 


BOOS function 7 has been chansed ta Get. Reader Status. It was 
Previously Get I/O Byte. BDOS function & has been changed ta Get 
Punch Status. It was previously Set 1/0 Byte. Nate, however 


that the IGQBYTE is still maintained in location 3 of the base 
Pase. These new status functions are supported br two new BIOS 
Public routines: RURSTF and PUNSTF. RDORSTF returns O in resister 
A if no character is ready for input’ otherwise it returns OFFH. 
PUNSTF returns O in resister A if the punch device is not ready ta 
accept a character for output; otherwise it returns OFFH. 


The BOOS supports function 113, Call Screen Function, which 
supports a variety of screen oriented sub-functions such as 
Position cursor, clear screen, etc. The BOOS does not support 
function 113 directly but passes the call to the BIOS public 
SCREENF routine. The SCREENF function must return a zero in 
resister H if it is not supported in the BIOS. 


The BDOS corrects the CP/M 2.2 Drive Reset (BDOS function 37) bus 
that does not allow a Program to reset the current disk. The 
redundant BIOS select operations performed in CF/M 2.2 are also 
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eliminated. 


Because Simple CP/M is rommable, the BOOS is linked with the 
BIOS to produce an absolute CPM.SYS file. For systems with ROM 
control is passed ta the BIOS cold start entry Paint when the system 
is booted. Otherwise, a cold boot loader loads the CPM.SYS file 
from the system tracks and passes control ta the BIOS cold start 
routine. The BIOS reads the CCP from the system tracks and locates 


it below the BOOS module at system cold or warm start. 
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